package com.newshub.business.mapper;

import com.newshub.business.entity.Region;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 区域Mapper接口
 */
@Mapper
public interface RegionMapper {
    
    /**
     * 根据ID查询区域
     */
    Region selectById(@Param("id") Integer id);
    
    /**
     * 插入区域
     */
    int insert(Region region);
    
    /**
     * 根据ID删除区域
     */
    int deleteById(@Param("id") Integer id);
    
    /**
     * 根据ID更新区域
     */
    int updateById(Region region);
    
    /**
     * 根据名称查询区域
     * @param name 区域名称
     * @return 区域对象
     */
    Region selectByName(@Param("name") String name);
    
    /**
     * 根据代码查询区域
     * @param code 区域代码
     * @return 区域对象
     */
    Region selectByCode(@Param("code") String code);
    
    /**
     * 查询所有区域
     * @return 区域列表
     */
    List<Region> selectAllRegions();
    
    /**
     * 分页查询区域
     * @param name 区域名称（可选）
     * @param code 区域代码（可选）
     * @param status 状态（可选）
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 区域列表
     */
    List<Region> selectByPage(@Param("name") String name, 
                             @Param("code") String code, 
                             @Param("status") Integer status,
                             @Param("offset") int offset, 
                             @Param("limit") int limit);
    
    /**
     * 统计分页查询的总数
     * @param name 区域名称（可选）
     * @param code 区域代码（可选）
     * @param status 状态（可选）
     * @return 总数
     */
    long countByPage(@Param("name") String name, 
                    @Param("code") String code, 
                    @Param("status") Integer status);
    
    /**
     * 更新区域状态
     * @param id 区域ID
     * @param status 新状态
     * @return 更新数量
     */
    int updateStatusById(@Param("id") Integer id, @Param("status") Integer status);
    
    /**
     * 批量删除区域
     * @param ids 区域ID列表
     * @return 删除数量
     */
    int deleteBatchByIds(@Param("ids") List<Integer> ids);
    
    /**
     * 批量插入区域
     * @param regions 区域列表
     * @return 插入数量
     */
    int insertBatch(@Param("regions") List<Region> regions);
    
    /**
     * 根据ID删除区域
     * @param id 区域ID
     * @return 删除数量
     */
    int deleteByIdCustom(@Param("id") Integer id);
    
    /**
     * 更新区域名称
     * @param id 区域ID
     * @param name 新名称
     * @return 更新数量
     */
    int updateNameById(@Param("id") Integer id, @Param("name") String name);
}